클라이언트와 서버 데이터 연동 (거래) 테스트

거래 정보 정의: 무엇을 주고받을까? (1/2)

거래 정보는 입력|출력 형식으로 dataMapInterface 을 구성하여, 콤마(,)로 구분하여 여러 정보를 구성합니다.

• 입력 정보 (클라이언트 -> 서버)

  • Row: 단일 건의 데이터 (예: 입력 폼 하나의 정보)
  • List: 여러 건의 데이터 (예: 그리드의 변경된 행 목록)

• 출력 정보 (클라이언트 <- 서버)

  • Form: 단일 건의 데이터 (예: 상세 조회 결과)
  • Grid: 여러 건의 데이터 (예: 목록 조회 결과)

거래 정보 정의: 무엇을 주고받을까? (2/2)

• 조합 예시
  • Row|Form: 단일 건을 보내고 단일 건을 받음 (저장 후 상세조회)
  • List|Grid: 목록을 보내고 목록을 받음 (다수 항목 상태 변경)

거래 Hook 이벤트: 언제 개입할까? (1/2)

거래의 특정 시점에 실행할 함수를 미리 정의하여 로직을 관리할 수 있습니다.

• beforeTransaction
  • 서버로 거래를 요청하기 직전에 호출됩니다.
  • 주로 입력값 유효성 검사, 데이터 전처리, 사용자 확인 창 표시에 사용됩니다.
  • 이 함수에서 false를 반환하면 거래 실행이 중단됩니다.

거래 Hook 이벤트: 언제 개입할까? (2/2)

• afterTransaction
  • 서버로부터 응답을 받은 직후에 호출됩니다.
  • 주로 응답 데이터 후처리, 특정 UI 상태 변경, 결과 메시지 표시에 사용됩니다.

거래 로직 구현 구조 (1/4)

페이지별 자바스크립트 파일에 hook과 transaction 객체를 정의하여 거래 관련 로직을 관리합니다.

거래 로직 구현 구조 (2/4)

'use strict';
let $TST010 = {
    hook: {
        beforeTransaction(transactConfig) {
            var functionID = transactConfig.functionID;
            if (functionID == 'LD02') {
            }
        },

        afterTransaction(error, functionID, responseData, addtionalData) {
            if (functionID == 'LD02') {

            }
        },

거래 로직 구현 구조 (3/4)

    },

    // 거래 메서드 선언
    transaction: {
        LD01: {
            inputs: [{ type: 'Row', dataFieldID: 'MainForm' }],
            outputs: [{ type: 'Grid', dataFieldID: 'DocumentList', clear: true }]
        },

        LD02: {
            inputs: [{ type: 'Row', dataFieldID: 'DocumentList' }],
            outputs: [{ type: 'Grid', dataFieldID: 'ReceiptList' }]
        }
    },

거래 로직 구현 구조 (4/4)

};

거래 계약 정보 (1/2)

클라이언트에서 요청되는 모든 데이터는 기본적으로 신뢰하지 않습니다.

• TST 프로젝트의 TST010 거래를 LD01 서비스 ID로 요청을 확인합니다.

• LD01 수신 정보는 인증 정보(Authorize)가 필요 한지 확인합니다.

• 반환되는 데이터 포맷은 무엇인지 확인합니다.

• 요청은 데이터베이스 요청으로 트랜잭션을 수행해야 하는지 확인합니다.

거래 계약 정보 (2/2)

• 요청 정보는 하나의 Row에 여러 Column으로 구성된 정보가 요청되며 이때 어떤 Fields 정보라도 허용합니다.

• 응답은 계약에 정의한 Form·Grid 등 출력 형식과 일치해야 합니다.

• 필수 입력 누락 사례로 서버 검증과 오류 응답을 확인합니다.

거래 요청과 응답 설정 (1/2)

{
    "ApplicationID": "HDS",
    "ProjectID": "TST",
    "TransactionID": "TST010",
    "Comment": "테스트 > 첫번째 테스트 거래",
    "Services": [
        {
            "ServiceID": "LD01",
            "Authorize": false,
            "ReturnType": "Json",
            "CommandType": "D",
            "TransactionScope": false,
            "Inputs": [],
            "Outputs": []

거래 요청과 응답 설정 (2/2)

        }
    ],
    "Models": []
}